<!DOCTYPE HTML>
<html lang="en">
<head>
  <meta name="copyright" content=
  "Copyright (c) IBM Corporation and others 2000, 2015. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page.">
  <meta charset="utf-8">
  <link rel="STYLESHEET" href="../book.css" type="text/css">
  <title>Ignoring Resources From Version Control</title>
</head>
<body>
  <h1 class="Head">Ignoring Resources From Version Control<</h1>
  <p>When synchronizing resources, it is possible that there are some resources that you do not want to commit to the
  repository. There are two ignore facilities provided, allowing you to specify what resources should be excluded from
  update and commit operations.</p>
  <p>The first is a global ignore facility, provided by the Workbench. The second is the VCS ignore facility, which
  reads the contents of a special file e.g .<i>gitignore</i> to determine what to ignore.</p>
  <h2>Why Ignore Files When Synchronizing?</h2>
  <p>There are many files that a user may not want to commit to the repository. For example, external editors may
  create temporary files in your project. Compilation of .java files creates .class files, and likewise many build
  operations result in binary files. These files, when taken together, may be quite large. In addition, they may be
  re-generated whenever a build is performed, resulting in many outgoing changes. Typically these are not files that
  one wants to share with other members of a team or persist in the repository.</p>
  <div class="Subtopic">
    <h2>Global Ignore Facility</h2>
    <p class="Head">A global ignore facility is provided by the Workbench via the <a class="command-link" href=
    'javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.team.ui.TeamPreferences)")'>
    <img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link"> <strong>Team</strong></a> preference
    page. There is a list of file patterns against which resources will be matched before they are considered as
    version control candidates. These patterns may contain the wildcard characters "*" and "?". "*" represents any
    sequence of zero or more characters. "?" represents any one character. For example, you can specify a pattern of
    "*~", which would match any temporary files that end with "~". Any file or directory that matches any one of the
    patterns will be ignored during update or commit operations. When you specify a file pattern to ignore, you can
    temporarily disable ignoring the file pattern by deselecting it from the list; you do not have to remove the
    specified file pattern from the list.<br>
    <br>
    The patterns in the global ignore facility are matched against resource names during a synchronize operation. It is
    important to note that the path leading up to the resource name is not included in the matching. For example, for
    the file "/path/to/file.txt", only the string "file.txt" is matched against the patterns. This facility is not
    intended for specifying fully-qualified path names but for specifying globally-applicable patterns.<br></p>
  </div>
</body>
</html>
